TableDataMake
生成表数据构造的事务
每次允许构造一个zone的表的数据。
请求地址
POST
http://OmsAddress/app/newoms.php/webservice/oamp/table-data/make?cmd=10011&ip-type=webservicerest&access-token=AccessTokenVal
POST请求参数说明
| 参数名称 | 数据类型 | 说明 | 是否必填字段 | 备注 |
|---|---|---|---|---|
| setId | 整型 | 事务所在的集群的id | 是 | |
| tableInfoList | 数组 | 构造数据的表，只允许构造一个zone下数据 | 是 | |
| ipList | 字符串 | 数据的机器上的路径，格式为：ip username password，并且账号密码中不能含有（\ l ; - 空格），多个用换行分开如：1.1.1.1 tcaplus tcaplus。(当useSlaveMachine为1时或者useSlaveOnlineData为1时，可以为空字符串) | 是 | |
| uLogBackupTime | 字符串 | Ulog构造数据时间点，格式：xxxx-xx-xx xx:xx:xx如2018-03-05 16:00:04 | 是 | |
| maxConcurrentActionNum | 整型 | 事务并行度，范围: [1, 50]，默认值：10 | 否 | |
| useSlaveOnlineData | 整型 | 表示热备构造，useSlaveOnlineData为1时，ipList、uLogBackupTime都是空 | 否 | |
| useSlaveMachine | 整型 | 表示在Slave机器上构造数据，在Slave机器上构造数据为1时，ipList可以不填。 | 否 | |
| isDeletedTable | 整型 | 表示是否为已删除表，当isDeletedTable为1时，uLogBackupTime和deleteTableLastBackupTime是必填，ipList也不能为空，useSlaveMachine为0。 | 否 |
Data参数
使用json格式表示记录相关信息，示例如下：
{
"setId": 126,
"tableInfoList": {
"2-3-add_table1": {
"AppID": 2,
"ZoneID": 3,
"TableName": "add_table1",
"ShardNun": 1,
"ShardList": [
1
]
},
"2-3-add_table2": {
"AppID": 2,
"ZoneID": 3,
"TableName": "add_table2",
"ShardNum": 1,
"ShardList": [
6
]
} //表的shard全部构造的时候，ShardList = ["All"]
},
"ipList":"1.1.1.1 tcaplus tcaplus","uLogBackupTime":"2018-03-07",
"maxConcurrentActionNum":10
}
//注：tableInfoList中的key格式为:{app_id}-{zone_id}-{table_name}
返回语法
返回参数说明
返回状态码不为200时，表示失败，返回数据为构造表数据失败的信息
返回状态码为200，表示表数据构造创建成功，返回的数据结构如下：
| 字段名称 | 数据类型 | 说明 | 备注 |
|---|---|---|---|
| trans_id | 整型 | 执行的对应的事务的id | |
| set_id | 整型 | 事务所在的集群 |
请求示例
通过 curl 方法发起请求
命令中的参数请参考本页中的“POST请求参数说明”，access-token的获取方法详见：获取access-token
curl -H "Content-type: application/json" -X "POST" -d '{
"setId": 126,
"tableInfoList": {
"2-3-add_table1": {
"AppID": 2,
"ZoneID": 3,
"TableName": "add_table1",
"ShardNun": 1,
"ShardList": [
1
]
},
"2-3-add_table2": {
"AppID": 2,
"ZoneID": 3,
"TableName": "add_table2",
"ShardNum": 1,
"ShardList": [
6
]
} //表的shard全部构造的时候，ShardList = ["All"]
},
"ipList":"1.1.1.1 tcaplus tcaplus", "uLogBackupTime":"2018-03-07",
"maxConcurrentActionNum":10
}
//注：tableInfoList中的key格式为:{app_id}-{zone_id}-{table_name}' http://omsaddress/app/newoms.php/webservice/oamp/table-data/make?cmd=10011&ip-type=webservicerest&access-token=<access-token>
返回示例
成功返回示例
http请求的Status=200
{
"set_id": "126",
"TransId": 108,
"username": "username"
}
错误返回
http请求的Status!=200
{
"name": "Unauthorized",
"message": "You are requesting with an invalid credential.",
"code": 0,
"status": 401,
"type": "yii\\web UnauthorizedHttpException"
}
{
"Error": [
"The Ulog retraction time point must be greater than the cold backup date"
]
}